home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / ansi / blank16b.zip / BLANKS.DOC < prev    next >
Text File  |  1989-04-20  |  18KB  |  365 lines

  1.  
  2.                  ------------------------------------------- 
  3.                     For personal, noncommercial use only     
  4.                     May not be sold - All rights reserved    
  5.                  ------------------------------------------- 
  6.  
  7.                  Copyright (C) 1988, 1989 by FM de Monasterio
  8.  
  9.                             BLANKs  version 1.6b
  10.                             --------------------
  11.  
  12.  
  13.          BLANKs is an MS-DOS/PC-DOS based, resident program that blanks the
  14.     screen after a preselected interval in the absence of a keypress.  This
  15.     interval can be selected from 1 to 60 minutes.  A selection higher than
  16.     60 minutes is set to 60.  Selecting 0 minutes disables screen blanking;
  17.     blanking can be enabled by re-invoking with an interval of 1 to 60 min.
  18.  
  19.     BLANKs is a TSR.  When resident, it uses less than 700 bytes; it can be
  20.     invoked repeatedly to change its settings without resulting in multiple
  21.     copies to memory.  BLANKs intercepts interrupts 8h, 9h, and 10h, and is
  22.     a well behaved resident, intended to run under MS-DOS or PC-DOS version
  23.     2.0 or later.
  24.  
  25.  
  26.                              ----------------
  27.  
  28.     OPERATION:
  29.  
  30.        Screen blanking is obtained by direct commands to the hardware (video
  31.     controller) to turn off/on the video signal.  This is a fast method that
  32.     operates successfully in the IBM PC/XT, PC/AT and in some IBM compatible
  33.     computers installed with MDA, CGA, EGA, VGA, and Hercules video adapters
  34.     or with IBM compatible adapters from other manufacturers.
  35.  
  36.  
  37.      NOTICE   In some nonIBM microcomputers the program may not work and it
  38.      ------   should NOT be used with other video adapter types unless they
  39.               are compatible with the IBM adapter at the register level (as
  40.               it is possible that some of these adapters might be damaged).
  41.  
  42.  
  43.     The resident component of BLANKs intercepts interrupts 8, 9, 10h and 33h
  44.     that subserve respectively the time-of-day, keyboard, BIOS video and (for
  45.     programs following the Microsoft's Mouse format) mouse operations.
  46.  
  47.     BLANKs will fail to operate if access to interrupts 8 and 9 is denied by
  48.     another program or resident loaded after BLANKs. This might occur with a
  49.     few communication and (older) word processing programs.
  50.  
  51.  
  52.   - Interrupt 8 is called 18.2 times/s to update the computer time-of-the-day
  53.     counter (which is stored in the BIOS data area).  Since a timer interrupt
  54.     can thus only operate within a period of about 55 ms or less (*including*
  55.     the overhead of DOS and other programs hooking on the timer), the program
  56.     uses direct commands to the hardware, written in assembly language, which
  57.     are issued (when needed) after the original timer interrupt is served.
  58.  
  59.   - Interrupt 9 is called when a key on the keyboard is pressed (or released).
  60.     When the hotkey service is enabled (see switch /H below), BLANKs triggers
  61.     blanking of the screen when the default hotkey combination (CTRL-B in non-
  62.     shareware versions) is pressed.  The hotkey code is then removed from the
  63.     keyboard buffer.  Other keys are passed along for keyboard processing and,
  64.     if a blanking had occurred, the screen is restored.
  65.  
  66.   - Interrupt 10h is called to mediate a number of video subfunctions. Because
  67.     such functions are comparatively slow, many programs do not use BIOS video
  68.     calls, but make direct writes to the screen (which are not detected by the
  69.     resident part of BLANKs).
  70.  
  71.   - Interrupt 33h is used in Microsoft's implementation of calls to the Mouse.
  72.     Other drivers, compatible with the Microsoft Mouse format, also implement
  73.     at least some of these calls.  Some graphics programs, however, do not use
  74.     these calls, and their resulting video activity is not detected by BLANKs.
  75.  
  76.  
  77.        NOTICE    To be able to monitor interrupt 33h, BLANKs must be installed
  78.        ------    *after* the mouse driver program as otherwise the driver will
  79.                  not allow access to the interrupt.  Also note that the driver
  80.                  for a well known mouse, upon its installation, can freeze the
  81.                  computer if interrupt 33h is found to be in use; this problem
  82.                  does not occur with other drivers, e.g. Logitech's MOUSE.COM.
  83.  
  84.  
  85.     Bypassing Interrupts:
  86.  
  87.     While installed, BLANKs bypasses the interrupt 8 when a blanking interval
  88.     of 0 minute has been selected (see below).   Interrupt 9 is bypassed only
  89.     when both an interval of 0 minute and the switch /H- (see below) have been
  90.     selected.  When /H- has been selected along with a nonzero interval, just
  91.     the hotkey service of interrupt 9 is bypassed.  Hence, these two interrupt
  92.     activities of BLANKs are bypassed by the "0 /H-" selection; this may be of
  93.     use in case of testing potential conflicts with other programs.
  94.  
  95.     Interrupts 10h and 33h are not intercepted when "/K[+]" is specified; when
  96.     this switch is not specified, these two interrupts are intercepted but not
  97.     monitored unless the switch "/V[+]" is specified.
  98.  
  99.     (In the shareware version, where cloning is available, if a cloned version
  100.     has been created with /K+ as the default condition, these 2 interrupts are
  101.     bypassed irrespective of whether switches "/K-" and/or "/V+" are specified
  102.     or not.  To access video activity monitoring, the program must be recloned
  103.     with a command line including the "/K- /C" switch selections.)
  104.  
  105.  
  106.                              ----------------
  107.  
  108.    USAGE:
  109.  
  110.     From the DOS command line or from a batch file, BLANKs is installed (or,
  111.     when already installed, modified) by the command:
  112.     
  113.                            BLANKs [?] [min] [/switches]
  114.  
  115.  
  116.         [?]   Invokes a brief help and status display, identifying the type
  117.               of adapter for which the program is configured, the current
  118.               adapter, and program settings (if installed).
  119.  
  120.               Pressing key <F1> displays further help on using the program.
  121.               If the program has not been installed, pressing key <D> shows
  122.               the default settings.
  123.  
  124.  
  125.        [min]  Timed blanking interval in minutes. These are the minutes that
  126.               the program waits before blanking the screen in the absence of
  127.               keyboard activity.   Valid selections are 0 or a number in the
  128.               range of 1 to 60.   The selection of a 0-min interval disables
  129.               the timed blanking of the screen; the selection of an interval
  130.               larger than 60 defaults to 60 minutes for 2 digit inputs or to
  131.               the value (in the valid range) of the first 2 digits in inputs
  132.               containing larger numbers.    
  133.  
  134.               Null interval defaults to 3 minutes.  This value may be changed
  135.               by cloning the program (see below).
  136.  
  137.  
  138.  
  139.     Several switches are recognized.  While shown as being preceded by a "/"
  140.     for the sake of clarity, the program accepts any character between space
  141.     [ ] and slash [/] as a switch delimiter [!"#$%&'()*+,-.].  Nonrecognized
  142.     switches abort loading of the program.  Switches are not case sensitive.
  143.  
  144.     NOTE:  Options marked with an asterisk (*) are available in the shareware
  145.            versions of BLANKs only.
  146.  
  147.  
  148.  
  149.         /U    Uninstall.   Use only when BLANKs was the last resident to be
  150.               installed, as otherwise this would create a "hole" in memory.
  151.  
  152.               The request is not honored if vectors to interrupts 8, 9 and
  153.               10h have been changed since installation.  This can be caused
  154.               by a resident installed after BLANKs, or by a prior resident
  155.               that changes vectors set by programs installed after it. You
  156.               can determine if this is the case by using any of the memory
  157.               mapping programs that are available (search for interrupts 8
  158.               9 and 10; BLANKs.COM will be shown as an unnamed entry using
  159.               736 or 656 bytes, depending on the switch selection.) 
  160.  
  161.  
  162.  
  163.         /C    Clone to disk the current